ChangedResource

Tag resource for update to disk

#include <Resources.h> Resource Manager

void ChangedResource(rHandle );

Handle rHandle ; handle of an existing resource

ChangedResource sets the resChanged bit of the specified resource

attribute and pre- allocates disk space to store the changes to the resource file.

When the resource file is closed, the resource map for the file, as well as the

data for the selected resource, will be written to disk.

rHandle is a resource handle. It is a handle obtained via GetResource,

Returns: none (if rHandle is not a valid resource handle, ResError will

return resNotFound. If the data cannot be written to disk, ResError

returns an operating system error code).

Notes: Use this if you expect to modify resource data or resource map

information (i.e., resource ID and/or name) and wish those changes to be

recorded to disk. Call ChangedResource immediately after making a

change you wish to preserve. The effect of this call shows up on the next

call to one of:

WriteResource to write data of a modified resource

UpdateResFile to update all modified resources in a file

CloseResFile to call UpdateResFile()

ExitToShell to call CloseResFile()

It is particularly important to check the success of this operation by

calling ResError. For instance, if the resource can not be written to disk

(e.g., if the disk is full), this is the only time you'll find out about it. If the

call fails, the resChanged attribute does not get set, so a call to

WriteResource will not see any error.

Note: This allocates additional disk space each time it is called.

Calling it repeatedly will eventually cause a floppy disk to fill up.

Use WriteResource to write the data and deallocate any extra space.

Precautions must be taken if any resource in a file is purgeable (see

GetResAttrs). If a resource is purged, and the resource map gets

written to disk, then an empty resource is written to disk. Use HNoPurge

and HPurge to ensure a resource remains in memory long enough to make a

valid update. Note too, that DetachResource removes a resource from the

resource map, and if that map gets written to disk, the resource data is

destroyed.

The only valid way to clear the resChanged attribute of a resource is to

write the resource to disk (see WriteResource).

Referenced by (32):